home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / apps / 641 / docs / m1as_doc.mnu < prev    next >
Text File  |  1992-10-22  |  32KB  |  891 lines

  1. #:main
  2.  ************************************
  3.  *****  KORG M1 Desk Assistant  *****
  4.  ************************************
  5. 0:-
  6.  
  7. +| * Introduction           *
  8. =:intro
  9. +| * The Main Screen        *
  10. =:menu
  11. +| * The Settings Dialog    *
  12. =:settingsdialog
  13. +| * The MIDI Dialog        *
  14. =:mididialog
  15. +| * Limitations            *
  16. =:limitations
  17. +| * Disclaimer             *
  18. =:disclaimer
  19. +| * Copyright              *
  20. =:copyright
  21. +| * Final Remarks          *
  22. =:final
  23.  
  24. /
  25. /
  26. #:help
  27. U|How to use this documentation program
  28.  
  29. Use the arrow keys or mouse to move around in the menus:
  30.  
  31. Up/down arrow or mousepointer selects the various menu entries.
  32. Right arrow/left mousebutton/Return selects an entry ('pops in').
  33. Left arrow/right mousebutton/Undo jumps to previous menu ('pops out').
  34. ClrHome always brings you to the main menu.
  35. Escape always exits the program.
  36. Help brings up this menu.
  37.  
  38. Now press the right mousebutton or the left arrow to go back to where
  39. you came from...
  40.  
  41. /
  42. /
  43. #:intro
  44. U|Introduction
  45. T:¯
  46. The KORG M1 Desk Assistant is in fact a small accessory version of the
  47. KORG M1 Bank Manager. 'Small' means that it misses a lot of functions of
  48. the Bank Manager. The Desk Assistant however also incorporates some
  49. functions that are not available in the Bank Manager! And since it's an
  50. accessory, you can call it from within any GEM program (i.e. a program
  51. with a menubar).
  52. The main purpose of this utility is to enable you to send sounds to the M1
  53. (or receive them from the M1 of course) from within any program, such as
  54. your sequencer. This way you can send the right set of sounds for a
  55. particular song to your M1 without having to leave the sequencer.
  56. In order to get started, you should copy the file M1_ASS.ACC to the root
  57. directory of your boot-drive (i.e. A:\ or C:\). It needs no aditional
  58. files, although it will create a settingsfile (M1_ASS.DAT) as soon as you
  59. save your customized settings (see the chapter on the Settings Dialog).
  60.  
  61. +:Next Page...
  62. =:intro2
  63. /
  64. /
  65. /
  66. #:intro2
  67. It's also possible to load the accessory with an accessory-loader such
  68. as CodeHead's MultiDesk or the Chameleon.
  69. And finally by simply renaming the accessory to M1_ASS.PRG you'll be able
  70. to run it as a stand-alone application!
  71.  
  72. Since the use of the Desk Assistant resembles the use of the Bank Manager
  73. in many respects, we recommend you to read the Bank Manager documentation
  74. first (start the M1BM_DOC.PRG) - a lot of what is discussed there will be
  75. assumed to be known in this document.
  76.  
  77. Just like the Bank Manager, the Desk Assistant consists of two different
  78. librarians - one for Programs and one for Combinations. When, in the
  79. following pages, we're talking about 'sounds', we always mean 'Programs
  80. or Combinations, depending on the currently active librarian'.
  81.  
  82. +:The Main Screen...
  83. =:menu
  84. /
  85. /
  86. /
  87. #:menu
  88. U|The Main Screen
  89. T:¯
  90. +: The Soundbox
  91. =:soundbox
  92. +: Load
  93. =:load
  94. +: Load Set
  95. =:loadset
  96. +: Save
  97. =:save
  98. +: Receive
  99. =:receive
  100. +: Send
  101. =:send
  102. +: Send Set
  103. =:sendset
  104. +: Sel./Desel.
  105. =:seldesel
  106. +: Delete
  107. =:delete
  108. +: Settings
  109. =:settings
  110. +: MIDI
  111. =:midi
  112. +: PROG/COMBI
  113. =:combiprog
  114. +: I/C
  115. =:ic
  116. +: Glb.Chan
  117. =:glbchan
  118. +: About
  119. =:about
  120. +: a/A
  121. =:aplay
  122. +: Quit
  123. =:quit
  124.  
  125. /
  126. /
  127. /
  128. #:soundbox
  129. U|The Soundbox
  130. T:¯
  131. The functionality of the soundbox (the central 100-slot box) is nearly
  132. identical to the Bank Manager's soundbox. Left clicking selects a slot,
  133. left-click and drag copies all selected sounds to the next free locations,
  134. starting at the slot above which you released the mouse and pressing either
  135. SHIFT-key while dragging will multi-(de-)select slots.
  136. When copying sounds while running as a program, the mouse will change to a
  137. flat hand and a so-called 'dragbox' the size of 5 slots will appear to
  138. remind you that you're 'doing something special'. When using the program as
  139. an accessory, the mouse will also change to a flat hand, but there will be
  140. _no_ dragbox, cause somehow the dragbox function crashes when used in accs.
  141. This is not my fault and it is not a bug in the program. I'm sorry for this
  142. cosmetic shortcoming...
  143.  
  144. The only difference with the Bank Manager is that it's not possible to
  145. rename sounds in the Desk Assistant.
  146.  
  147. +:Load...
  148. =:load
  149. +:Back to 'The Main Screen'
  150. =:menu
  151. /
  152. /
  153. /
  154. #:load
  155. U|Load
  156. T:¯
  157. The 'Load' button opens a file-selector in which you can pick the Bank
  158. Manager file to be loaded (either a MPR or a MCO file, depending on
  159. which part of the program you're currently using - see the page on the
  160. PROG/COMBI button). You need not supply the file-extension, as the program
  161. automatically appends the right extension to the filename you've entered.
  162. The various sophistcated load-settings of the Bank Manager are not
  163. available - after having selected a file you'll be given the choice between
  164. loading to the first free positions ('load to free') - just like the BM's
  165. default behaviour - or loading to the positions that are stored in the BM
  166. file ('load to positions').
  167. Note that 'load to positions' will overwrite sounds already present at
  168. those positions without warning.
  169. Note also that the program will remember the folder you last selected a
  170. file from, so that next time the fileselector opens it will show you the
  171. same folder. The first time you select a file, the program will use the
  172. folder you entered as the default-path in the settings-dialog (provided
  173. you saved settings afterwards of course - more on this in the chapter
  174. 'The Settings Dialog').
  175.  
  176. +:Load Set...
  177. =:loadset
  178. +:Back to 'The Main Screen'
  179. =:menu
  180. /
  181. /
  182. /
  183. #:loadset
  184. U|Load Set
  185. T:¯
  186. This is the button labeled 'Set' to the right of the 'Load' button  (it
  187. was too small to put both words in it...). 'Load Set' is a feature not
  188. available in the Bank Manager.
  189. A 'set' consists of two files - a program file (MPR) and a combination file
  190. (MCO), both with the same filename (but different extensions of course).
  191. Both files *must* be located in the default-directories you entered in the
  192. Settings-dialog. When you load a set, you will first be asked to confirm
  193. this operation, since loading a set will clear *all* internal memory -
  194. which means that all currently loaded programs and combis will be erased!!
  195. If you confirm this, you will then be asked to select a program-file (even
  196. when you're currently in the combination-librarian). The program now loads
  197. this file to the program-librarian and next looks for the corresponding
  198. combi-file, that will then be loaded too.
  199.  
  200. +:Next Page...
  201. =:loadset2
  202. /
  203. /
  204. /
  205. #:loadset2
  206. So when your program folder is e.g. A:\PROGRAMS\ and your combination
  207. folder is A:\COMBIS\, and you have a file MYSOUND.MPR in the first and
  208. MYSOUND.MCO in the second folder, then performing a 'Load Set', and
  209. selecting the MYSOUND.MPR file will load both files at the same time.
  210.  
  211. Before a set is loaded, you will also be asked if you want to send the set
  212. to the M1 immediately after it is loaded. If you choose 'Yes', the program
  213. will send all programs and combis in the set to the M1 as soon as both
  214. files are loaded.
  215.  
  216. What's the purpose of this operation? For most pieces of music you need a
  217. certain set of sounds (programs) and a certain multi-timbral setup (combi).
  218. When you store the needed sounds and combi(s) in two files with the same
  219. name, the 'Load Set' operation makes it possible to send all the necessary
  220. data to the M1 with only one action. This makes dumping setups very fast
  221. and easy: 'Load Set', -Are you sure?- 'Yes', -Send set after loading?-
  222. 'Yes', select a file, and ready you are! In the 'Settings Dialog' you'll
  223. learn how you can even avoid those dialogs - so only two mouseclicks will
  224. have your M1 ready and set to play your song!
  225.  
  226. +:Save...
  227. =:save
  228. +:Back to 'The Main Screen'
  229. =:menu
  230. /
  231. /
  232. /
  233. #:save
  234. U|Save
  235. T:¯
  236. This will save all (and only) the *selected* sounds. Enter the name of the
  237. file in the fileselector (again no need to supply the file-extension).
  238. When the file you choose already exists and 'Safety Warnings' is on (see
  239. the chapter on the Settings Dialog), you will be asked if you want to
  240. overwrite this file.
  241.  
  242. +:Receive...
  243. =:receive
  244. +:Back to 'The Main Screen'
  245. =:menu
  246. /
  247. /
  248. /
  249. #:receive
  250. U|Receive
  251. T:¯
  252. Receives all sounds from the M1 corresponding to the *selected* slots
  253. (just like in the Bank Manager). You can abort this operation while it's
  254. being performed by pressing the _right_ mousebutton.
  255. If 'Double Check Data' in the Settings-dialog is on, every dump is
  256. performed at least twice to ensure almost 100% data integrity.
  257.  
  258. +:Send...
  259. =:send
  260. +:Back to 'The Main Screen'
  261. =:menu
  262. /
  263. /
  264. /
  265. #:send
  266. U|Send
  267. T:¯
  268. All (and only) the *selected* sounds will be sent to the M1. You will
  269. get no safety warnings, so be careful as you might loose valuable data.
  270. You can abort this operation while it's being performed by pressing the
  271. _right_ mousebutton.
  272. +:Send Set...
  273. =:sendset
  274. +:Back to 'The Main Screen'
  275. =:menu
  276. /
  277. /
  278. /
  279. #:sendset
  280. U|Send Set
  281. T:¯
  282. The button next to the 'Send' button, labeled 'Set', performs the 'Send
  283. Set' operation (again the button was too small to stuff both words in it).
  284. Sending a set means that the *complete contents* of both the program
  285. librarian and the combination librarian is sent to the M1 - *regardless
  286. of whether slots are selected or not*. So _everything_ is sent!
  287. This is mainly intended for use with the 'Load Set' operation - once
  288. you've loaded a set that contains all the program and combination data
  289. you need for a song, you can dump all this data to the M1 with a single
  290. mouseclick.
  291. You can abort this operation while it's being performed by pressing the
  292. _right_ mousebutton.
  293. If 'Safety Warnings' is switched on in the Settings-dialog, you will be
  294. asked for confirmation.
  295.  
  296. +:Sel./Desel...
  297. =:seldesel
  298. +:Back to 'The Main Screen'
  299. =:menu
  300. /
  301. /
  302. /
  303. #:seldesel
  304. U|Sel./Desel.
  305. T:¯
  306. The 'Sel' button will select all slots (if it had been bigger, it
  307. would have read 'Select All'). The 'Desel' button does the opposite:
  308. it deselects all slots (and should have read 'Deselect All'...).
  309.  
  310. +:Delete...
  311. =:delete
  312. +:Back to 'The Main Screen'
  313. =:menu
  314. /
  315. /
  316. /
  317. #:delete
  318. U|Delete
  319. T:¯
  320. This deletes all *selected* sounds.
  321. If the 'Safety Warnings' in the Settings-dialog is on, you'll be
  322. asked to confirm this operation.
  323.  
  324. +:Settings...
  325. =:settings
  326. +:Back to 'The Main Screen'
  327. =:menu
  328. /
  329. /
  330. /
  331. #:settings
  332. U|Settings
  333. T:¯
  334. This brings up the Settings-dialog in which you can adjust the behaviour
  335. of the Desk Assistant to suit your needs/taste.
  336. More on the Settings-dialog in the corresponding chapter...
  337.  
  338. +:MIDI...
  339. =:midi
  340. +:Back to 'The Main Screen'
  341. =:menu
  342. /
  343. /
  344. /
  345. #:midi
  346. U|MIDI
  347. T:¯
  348. This button brings up the MIDI-dialog in which you can perform various
  349. MIDI-specific actions, like sending program- or mode-changes.
  350. More on this in the chapter 'The MIDI Dialog'.
  351.  
  352. +:PROG/COMBI...
  353. =:combiprog
  354. +:Back to 'The Main Screen'
  355. =:menu
  356. /
  357. /
  358. /
  359. #:combiprog
  360. U|COMBI/PROG
  361. T:¯
  362. This button switches between the Program- and Combination-librarian.
  363. When you're in the Program-librarian it will read 'COMBI' (and v.v.)
  364. which means that you'll go to COMBI mode when you click it (is this
  365. confusing?).
  366. Note that no data is lost when you switch modes - just like in the
  367. Bank Manager these are two completely separate and independant
  368. 'departments' with their own data-structures and memory.
  369.  
  370. +:I/C...
  371. =:ic
  372. +:Back to 'The Main Screen'
  373. =:menu
  374. /
  375. /
  376. /
  377. #:ic
  378. U|I/C
  379. T:¯
  380. The small 'I' and 'C' buttons switch between Internal memory and (ROM
  381. or RAM) Card.
  382. Since switching from I to C and v.v. will erase *all loaded data* (i.e.
  383. both librarians), you will always be asked to confirm this operation,
  384. even if you turned the 'Safety Warnings' off in the Settings-dialog.
  385. The button corresponding to the 'area' you're currently using will be
  386. disabled (hardly useful to switch to Internal when you're already in
  387. Internal, is it...?).
  388. Note that you can *always* switch between I and C - even if no card is
  389. inserted. However, you won't be able to *write* (=send) any sounds to
  390. a non-existing card (well, wadda ye think...). It _is_ possible to
  391. receive in C-mode even if no card is present - the program will then
  392. receive the M1's 'Internal' sounds - although this is hardly useful...
  393. The program always starts in 'I'-mode.
  394.  
  395. +:Glb.Chan...
  396. =:glbchan
  397. +:Back to 'The Main Screen'
  398. =:menu
  399. /
  400. /
  401. /
  402. #:glbchan
  403. U|Glb.Chan
  404. T:¯
  405. The Global Channel is the MIDI-channel used to communicate with the M1.
  406. It is therefore very important that this is set correct, otherwise
  407. M1 I/O won't be possible.
  408. Everytime you open the accessory (or, when running as a program, upon
  409. startup), the program tries to retrieve the Global Channel from the M1
  410. automatically. If this somehow fails, you will be notified. In this
  411. case, or in case you change the M1's Global Channel while the program is
  412. running, you have to set the channel manually. Do this by left-clicking
  413. on the channel number - this will cycle through all the 16 MIDI-channels.
  414.  
  415. +:About...
  416. =:about
  417. +:Back to 'The Main Screen'
  418. =:menu
  419. /
  420. /
  421. /
  422. #:about
  423. U|About
  424. T:¯
  425.  
  426. U| Click and read...
  427. T| It's important.
  428.  
  429. T|Ha!
  430.  
  431. +:a/A
  432. =:aplay
  433. /
  434. /
  435. /
  436. #:aplay
  437. T|a/A
  438. T:¯
  439. The small button right of the 'About' button is the Autoplay button. When
  440. it shows an 'a', Autoplay is OFF. When you see an 'A', Autoplay is ON.
  441. This is a somewhat simplified Autoplay, compared to the Bank Manager's.
  442. When you select a sound, Autoplay will send the sound to the M1, without
  443. writing it. Next it sends a note-on for C3 (middle C) with velocity 64.
  444. It then waits a little while before turning the note off. When you 'drag
  445. select', only the _first_ sound you select will be Autoplay-ed.
  446. The Autoplay ON/OFF flag is saved when you save settings.
  447.  
  448. +:Quit...
  449. =:quit
  450. +:Back to 'The Main Screen'
  451. =:menu
  452. /
  453. /
  454. /
  455. #:quit
  456. U|Quit
  457. T:¯
  458. Well, uh..., yeah, wonder what this button is for...
  459. Probably some kinda..., well, actually I think it's
  460. a..., well, you know what...
  461.  
  462. +:The Settings Dialog...
  463. =:settingsdialog
  464. +:Back to 'The Main Screen'
  465. =:menu
  466. /
  467. /***************** SETTINGS DIALOG **************************
  468. /
  469. #:settingsdialog
  470. U|The Settings Dialog
  471. T:¯
  472. When you click the 'Settings' button in the main screen, the settings
  473. dialog will open. It is here that you can customize the behaviour of
  474. the Desk Assistant to suit your own taste.
  475.  
  476. The two buttons in the upper left corner, labeled 'Programs' and
  477. 'Combis' will bring up the fileselector. You now can select the
  478. default paths for both Programs and Combis separately. Next time you
  479. run the program, these paths will be used as the default directories.
  480. Whenever you load a Set (i.e. a MPR file and a corresponding MCO file),
  481. the program requires these files to be in the default directories!
  482.  
  483. The two buttons 'Disable Prog.Mode' and 'Disable Comb.Mode' will disable
  484. one of the librarians (you're not allowed to disable both). This should
  485. not be necessary, but in case you're very short on memory, it might be
  486. useful, since disabling one librarian will reduce the programs memory-
  487. usage by nearly 50%.
  488.  
  489. +:Next Page...
  490. =:sd2
  491. /
  492. /
  493. /
  494. #:sd2
  495. Note that changes to these mode settings will only take effect the next
  496. time you start the program (i.e. when running as an acessory: the next
  497. time you boot your computer).
  498.  
  499. Next there are four buttons that influence the Desk Assistant's behaviour:
  500. - Double Check Data: When this button is selected (i.e. black), everytime
  501.   a sound is received from the M1, the data is 'double checked' to ensure
  502.   data integrity. This slows down receiving sounds a bit, but nevertheless
  503.   we'd recommend you to have this option switched on.
  504. - Safety Warnings: For some operations a safety-warning will be issued,
  505.   enabling you to cancel the operation. When this button is 'off', all
  506.   safety warnings will be skipped. Safety warnings apply to: 'Load Set',
  507.   'Send Set', 'Delete', 'Save' in case you want to overwrite an already
  508.   existing file, 'Copy' (by dragging the selected sounds) and 'Quit'. This
  509.   last warning will only be issued when The DA is running as a program,
  510.   since quitting when it's an accessory won't loose any data.
  511.   Note that the warning you get when changing from Internal to Card, or
  512.   v.v., will _always_ be given, even if 'Safety Warnings' is off.
  513.  
  514. +:Next Page...
  515. =:sd3
  516. +:Back to 'The Settings Dialog'
  517. =:settingsdialog
  518. /
  519. /
  520. /
  521. #:sd3
  522. - Use M1 Edit Modes: When this button is selected, the M1 will always be
  523.   switched to EDIT PROG or EDIT COMBI mode, after M1 I/O (i.e. sending or
  524.   receiving of sounds) is completed. This is useful in case you want to
  525.   send parameter changes through Sys-Ex after you have dumped sounds to the
  526.   M1, since parameter changes can only be received in the edit-modes. For
  527.   instance, you could have a sequencer-song that contains such Sys-Ex data,
  528.   so you want the M1 to be in EDIT COMBI mode after you've send the 'Set'
  529.   for this song.
  530. - Invert SHIFT-key: This does the same as the Bank Manager's 'Invert...'.
  531.   Normally, dragging in the soundbox will copy the selected sounds, while
  532.   pressing either SHIFT-key while dragging will multi-(de)select slots.
  533.   'Invert SHIFT-key' inverts this operation: drag to multi-select and
  534.   SHIFT-drag to copy. This option was included in the DA to enable you to
  535.   have the same 'feel' as you're used to in the Bank Manager - it would be
  536.   very annoying when both programs worked in opposite ways...
  537.  
  538. +:Next Page...
  539. =:sd4
  540. +:Back to 'The Settings Dialog'
  541. =:settingsdialog
  542. /
  543. /
  544. /
  545. #:sd4
  546. The next box contains three radio-buttons. Here you determine the 'Switch
  547. upon exit' behaviour. If 'Program mode' is selected, the Desk Assistant
  548. will switch the M1 to Program Mode automatically when you leave the
  549. program. Selecting 'Combination Mode' will switch the M1 to Combi Mode
  550. upon exit. Selecting 'None' won't send any mode changes when you leave the
  551. DA. Note that the 'Switch upon exit' behaviour also depends on the setting
  552. of the 'Use M1 Edit Modes' button: when 'Use M1 Edit Modes' is _on_,
  553. selecting 'Switch upon exit: Combination mode' will cause the program to
  554. switch the M1 to Combination _Edit_ Mode upon exiting, whereas having the
  555. 'Use M1 Edit Modes' turned off will switch the M1 to plain Combi Mode.
  556.  
  557. The box on the far right contains another three radio buttons. These
  558. determine what happens when you load a 'Set'. Selecting 'Always' will
  559. cause sets to be always sent to the M1 immediately after loading. 'Never'
  560. will prevent sets from being sent after loading. 'Query' will cause the
  561. program to ask you if you want to send the set immediately afterwards.
  562. Be very careful with the 'Always' button...
  563.  
  564. +:Next Page...
  565. =:sd5
  566. +:Back to 'The Settings Dialog'
  567. =:settingsdialog
  568. /
  569. /
  570. /
  571. #:sd5
  572. The last button, 'Ignore M1', will cause the program to ignore the M1 (ha!).
  573. That means that no MIDI I/O is performed (e.g. no mode changes are sent
  574. went you switch between the program and combination librarians). This is
  575. useful in case your M1 is turned off, because you only want to use the
  576. program for some library-job (i.e. disk I/O) - not ignoring the M1 in this
  577. case would give you MIDI error messages on lots of actions, such as
  578. switching from 'PROG' to 'COMBI, switching from Internal to Card, leaving
  579. the Settings or MIDI dialog, etc. This would be very annoying and time
  580. consuming... Note that you're not allowed to send/receive when 'Ignore M1'
  581. is ON.
  582.  
  583. Finally you can save the settings you made by pressing the 'Save Settings'
  584. button. All settings made will be written to the file M1_ASS.DAT that will
  585. be read the next time you start the program or boot your computer. This
  586. file will contain all settings you made here, the Autoplay flag and the
  587. settings made in the MIDI dialog. The one exception is the 'Ignore M1'
  588. button - this will not be saved and will default to 'off'. This means that
  589. when your M1 is turned off, or not connected to your ST, the first time you
  590.  
  591. +:Next Page...
  592. =:sd6
  593. +:Back to 'The Settings Dialog'
  594. =:settingsdialog
  595. /
  596. /
  597. /
  598. #:sd6
  599. select the accessory from the menu (or when you start the program), you
  600. will get a MIDI error message. Just ignore it and go to the Settings
  601. Dialog as soon as the main screen appears, turning 'Ignore M1' on.
  602.  
  603. If you find this all a bit confusing, select the 'An example please' menu
  604. entry below. I'll tell you how I use the settings myself and what their
  605. effect is. If you think everything is perfectly clear, move to 'The MIDI
  606. Dialog'.
  607.  
  608. +:An example please...
  609. =:sd7
  610. +:The MIDI Dialog...
  611. =:mididialog
  612. +:Back to 'The Settings Dialog'
  613. =:settingsdialog
  614. /
  615. /
  616. /
  617. #:sd7
  618. U|An Example
  619. T:¯
  620. My folder structure is as follows:
  621. M1_BANKS\COMBIS\        <- contains the combi-libraries
  622. M1_BANKS\PROGRAMS\      <- contains the program-libraries
  623. M1_BANKS\SONGS\         <- contains 'sets' for sequencer songs
  624. M1_BANKS\SYSEX\         <- contains SysEx dumps (drum maps, backups, etc.)
  625. The COMBIS, PROGRAMS and SYSEX folders are the default folders for the
  626. Bank Manager. The SONGS folder is the default folder for the Desk Assistant
  627. This folder contains both program and combi files - a set for each
  628. sequencer song.
  629.  
  630. I use the following settings: Double Check Data ON; Safety Warnings OFF
  631. (hate those alerts...); Use M1 Edit Modes ON (since many of my songs
  632. contain SysEx data, I want the M1 to be ready to receive those SysEx
  633. parameter changes); Invert SHIFT-key ON (matter of taste).
  634. Furthermore: Switch upon exit = Combination Mode;
  635.              Send set after load = Query.
  636.  
  637. +:Next Page...
  638. =:sd8
  639. +:Back to 'The Settings Dialog'
  640. =:settingsdialog
  641. /
  642. /
  643. /
  644. #:sd8
  645. If I have a song called HITSONG, I make a set consistng of the files
  646. HITSONG.MPR and HITSONG.MCO that contain all the programs and the combi the
  647. M1 needs in order to play the song. If I now load this set, I can send it
  648. to the M1 immediately after loading, quit the program and, since 'M1 Edit
  649. Modes' is ON and 'Switch upon exit' = Combi mode, the M1 will be in Combi
  650. Edit mode when I return in my sequencer - ready to play the song and
  651. receive the SysEx data contained therein.
  652.  
  653. The Settings dialog makes the program very flexible (in my opinion),
  654. although it may take some time to get used to all the possibilities.
  655. Well, on the other hand... I suppose you won't change the settings
  656. every day, will you?
  657.  
  658. +:The MIDI Dialog...
  659. =:mididialog
  660. +:Back to 'The Settings Dialog'
  661. =:settingsdialog
  662. /
  663. /***************** MIDI DIALOG ******************************
  664. /
  665. #:mididialog
  666. U|The MIDI Dialog
  667. T:¯
  668. When you press the 'MIDI' button in the main screen, the MIDI Dialog will
  669. open. Here you can perform various, mostly M1-related, MIDI actions.
  670.  
  671. In the upper left corner you see a left and a right arrow and a number,
  672. labeled 'Program Change'. Use the arrows to cycle through all the legal
  673. program numbers (0-127). Click on the number itself to send the
  674. corresponding program change to your gear. The program change will be sent
  675. on the global channel that is set in the main screen. Note that program
  676. changes will only be handled by the M1 when in Program mode or Combi mode.
  677.  
  678. Next you see 8 buttons labeled 'Mode Change'. Clicking on one of those will
  679. send the corresponding mode change to the M1 - also using the global
  680. channel.
  681.  
  682. The next two buttons, 'Dump Request', send a dump request to the M1 -using
  683. the global channel again. If the M1 receives this message, it will respond
  684. by sending the corresponding (i.e. programs or combi) data dump. What the
  685. use of this might be will be explained in a moment - just read on.
  686.  
  687. +:Next Page...
  688. =:md2
  689. /
  690. /
  691. /
  692. #:md2
  693. The last three buttons on the left side of the screen are labeled 'Local
  694. on', 'Local off' and 'All Notes Off'. The first two put the M1 in Local on/
  695. off mode, which means the keyboard will be (dis)connected to/from the sound
  696. generation part (and again the global channel will be used here). The 'All
  697. Notes Off' button sends an 'all notes off' message on _all_ MIDI channels.
  698. This will definitely turn off all stuck notes on all your MIDI machines.
  699.  
  700. Central in the MIDI dialog are the 6 boxes with the big 'Send' buttons.
  701. These allow you to send arbitrary MIDI messages to your machines. Every
  702. box contains two fields: the upper, 12 character field is intended for
  703. name-giving. Since MIDI-messages in general don't look too meaningful, you
  704. may enter a descriptive name here for the message you defined. The lower
  705. field is supposed to contain the MIDI message. Here you should enter a
  706. sequence of hexadecimal characters, that will be sent as soon as you press
  707. the corresponding 'Send' button. Hexadecimal messages consist of the
  708. characters 0-9 and A-F (or a-f). Note that it is possible to enter non-
  709. legal characters in the message field! Messages with illegal characters
  710. will not be sent, and an alert will warn you on this.
  711.  
  712. +:Next Page...
  713. =:md3
  714. +:Back to 'The MIDI Dialog'
  715. =:mididialog
  716. /
  717. /
  718. /
  719. #:md3
  720. Note that messages sent from within this dialog will be sent regardless of
  721. whether MIDI-gear is connected or not. So, while it's not possible to send
  722. or receive sounds when you've got 'Ignore M1' in the Settings Dialog turned
  723. ON, it _is_ possible to send all kinds of MIDI messages from within the
  724. MIDI-dialog in this case, since the MIDI dialog sends plain MIDI data,
  725. without doing any error checking.
  726.  
  727. The upper two of the six message fields are partially pre-defined. The top-
  728. message will automatically send a M1 system-exclusive header: F0-42-3x-19,
  729. where the 'x' means 'the current global channel' (of course no actual 'x'
  730. is sent, since 'x' is an illegal character!), and an 'end-of-exclusive'
  731. (F7). So here you only have to supply the 'body' of a M1 Sys-Ex message.
  732. The second field can be used for sending Sys-Ex to other machines, since
  733. it automatically sends 'begin of exclusive' and 'end of exclusive' (F0 and
  734. F7 resp.). Of course you can also use this field to send Sys-Ex to the M1,
  735. but in that case you have to provide the header (42-3x-19) yourself.
  736. The other 4 fields can be used for any kind of MIDI message (including
  737. Sys-Ex of course). You could for example define a note-on and a note-off,
  738.  
  739. +:Next Page...
  740. =:md4
  741. +:Back to 'The MIDI Dialog'
  742. =:mididialog
  743. /
  744. /
  745. /
  746. #:md4
  747. in order to be able to listen to a particular patch, while your M1 is
  748. on the other side of the room.
  749.  
  750. Finally there is the 'Immediate Exit' button. When you select this, nothing
  751. seems to happen. However, as soon as you select one of the other buttons
  752. (i.e. send a mode change, one of the MIDI messages, or whatever), the
  753. program will exit immediately after having sent the requested message! The
  754. idea is thus: suppose you want your sequencer to receive a program dump.
  755. You should then send a program dump request from within the sequencer and
  756. put it in 'record' mode. This may however be tedious. Now when you use the
  757. DA, you can turn on 'Immedaite Exit' and send a dump request. Since the DA
  758. exits immediately after having sent the request, it might be that control
  759. is given back to your sequencer _before_ M1 data starts arriving at the
  760. MIDI port... Unfortunately this trick doesn't seem to work with _my_
  761. sequencer, but maybe you have better luck... (well, the _idea_ isn't that
  762. bad, is it...?)
  763.  
  764. All settings made in the MIDI dialog, except for the 'Immediate Exit'
  765. button, will be saved when you 'Save Settings' in the Settings Dialog.
  766.  
  767. +:Limitations...
  768. =:limitations
  769. +:Back to 'The MIDI Dialog'
  770. =:mididialog
  771. /
  772. /
  773. /
  774. #:limitations
  775. U|Limitations
  776. T:¯
  777. The Desk Assistant should run in all resolutions. However, in low-rez on a
  778. normal monitor (320x200), the dialog won't fit on the screen, so you should
  779. use e.g. a A3-monitor (...hmm...). In med-rez the dialog *does* fit on the
  780. screen, but will be messed up a bit, due to alignment problems (programmers
  781. among you will now what I'm talking about - the rest: please ignore this
  782. remark).
  783. The program uses as little memory as possible, so in normal use it should
  784. give you no memory-problems. If it does, try disabling one of the DA's
  785. librarians (although I can't imagine it to be necessary).
  786.  
  787. Other limitations...? Let me know.
  788.  
  789. +:Disclaimer...
  790. =:disclaimer
  791. +:Home...
  792. =:main
  793. /
  794. /***************** COPYRIGHT & DISCLAIMER *******************
  795. /
  796. #:disclaimer
  797. U|Disclaimer
  798. T:¯
  799. Because you haven't paid a dime for it, the author and So What? software
  800. don't take any responsibility  for any damage real or perceived, caused or
  801. not caused by this program. We don't mind how bad you f*ck up your hard
  802. disk, your computer, your M1, your man or wife or favourite pet: we are not
  803. to blame, not even in case of loss of files, loss of lifes, lethal
  804. explosion of your system, fire, third world war, or whatever.
  805. This software is delivered 'as is' and free of known bugs and it is solely
  806. your responsibility if you don't know how to use it properly. And even if
  807. you know how to use it properly, it's solely your responsibility that you
  808. use the program at all.
  809. We think you got a nice piece of software for an absolute minimum price, so
  810. don't bother us with complaints.
  811.  
  812. As always, serious bug reports or suggestions for improvements are more
  813. than welcome of course. If you send a bug report together with a self-
  814. addressed, stamped envelope and formatted (DD) disk, I'll send you the
  815. debugged version of the program. Make sure that your bug report contains
  816. enough information for me to be able to reproduce the bug.
  817.  
  818. +:Copyright...
  819. =:copyright
  820. /
  821. /
  822. /
  823. #:copyright
  824. U|Copyright
  825. T:¯
  826.  
  827. The program and it's source are copyrighted (C) 1990/1992 by
  828. * So What? * software. You are however permitted to make copies
  829. of the program and give them away or put them on bulletin boards,
  830. provided no changes were made to the original files - we don't
  831. want to receive complaints because some dude messed up a
  832. resource file, or because the documentation is missing.
  833.  
  834. The source code is *not* available.
  835.  
  836. +:Final Remarks
  837. =:final
  838. +:Home...
  839. =:main
  840. /
  841. /***************** FINAL REMARKS ********************************
  842. /
  843. #:final
  844. U|Final remarks
  845. T:¯
  846. Enjoy the M1 Desk Assistant!
  847. If you want to send me
  848. 1. a postcard, telling me how absolutely marvelous the program is;
  849. 2. suggestions for next versions (more options? tell me and I'll consider
  850.    them seriously);
  851. 3. high quality soft drugs;
  852. 4. good looking, unmarried young daughters;
  853. 5. large amounts of money;
  854. then use the address below. If you've got any comments, bug reports,
  855. suggestions for future versions, or whatever, let me know. I've tried -
  856. and will continue trying- to make this program as fool-proof and bug-free
  857. as possible, but I need you, the user, to know what bugs are left and what
  858. features you'd like to see in future versions.
  859. I don't expect to receive any money for this program, but I would very much
  860. appreciate receiving any patches you made for your M1. I spent months
  861. writing this package, and I provided you with tons of sounds for your M1,
  862. so do I really ask too much? Watch your BBS and the various Atari archives
  863. for new versions of this program!
  864.  
  865. +:Next Page...
  866. =:final2
  867. /
  868. /
  869. #:final2
  870. The program you started to read this documentation was written with the
  871. help of the Pure-C HELP-library - another marvelous So What? product.
  872. Sources and executables of this lib and the accompanying programs are
  873. completely public domain - check your local BBS or the various atari
  874. archives!
  875.  
  876.   I can be reached at:
  877.  
  878.   snailmail:                 email:
  879.  
  880.   Hendrik Jan Veenstra       Internet:  hjv@phil.ruu.nl
  881.   Lepelaarstraat 27
  882.   3582 SL   Utrecht          SterBBS (the largest ST bbs):
  883.   The Netherlands            01880 - 40035    user_ID: hjv
  884.  
  885.  
  886. And remember: the purpose of this program is solely to speed up
  887. non-relevant work, so you'll have more time free to write good
  888. music.
  889.  
  890. +:Home...
  891. =:main